home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 015a / env_30.zip / ENVIRON.DOC < prev    next >
Text File  |  1993-05-01  |  26KB  |  530 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.   █████████   ███   ███   ███   ███   ███   ████████     ███████    ███   ███
  16.   ███▒▒▒▒▒▒▒  ████  ███▒  ███▒  ███▒  ███▒  ███▒▒▒███   ███▒▒▒███   ████  ███▒
  17.   ███▒        █████ ███▒  ███▒  ███▒  ███▒  ███▒  ███▒  ███▒  ███▒  █████ ███▒
  18.   ████████    ███▒█▒███▒  ███▒  ███▒  ███▒  ████████▒▒  ███▒  ███▒  ███▒█▒███▒
  19.   ███▒▒▒▒▒▒   ███▒█████▒   ███ ███▒▒  ███▒  ███▒███▒▒   ███▒  ███▒  ███▒█████▒
  20.   ███▒        ███▒ ████▒   ███▒███▒   ███▒  ███▒ ███    ███▒  ███▒  ███▒ ████▒
  21.   █████████   ███▒  ███▒    ▒███▒▒▒   ███▒  ███▒  ███    ███████▒▒  ███▒  ███▒
  22.    ▒▒▒▒▒▒▒▒▒   ▒▒▒   ▒▒▒      ▒▒▒      ▒▒▒   ▒▒▒   ▒▒▒    ▒▒▒▒▒▒▒    ▒▒▒   ▒▒▒
  23.  
  24.                                   Version 3.0
  25.                                   May 1, 1993
  26.  
  27.  
  28.  
  29.                        Copyright 1992, 93 by David E. Key
  30.                                 Arlington, Texas
  31.  
  32.                              CompuServe 76264,1532
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                TABLE OF CONTENTS
  63.      _____________________________________________________________________
  64.  
  65.  
  66. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  67.  
  68. OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  69.  
  70. CHAPTER 1 - SYSTEM REQUIREMENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  71.       HARDWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  72.       A NOTE ON VIDEO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  73.  
  74. CHAPTER 2 - EXECUTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  75.       USER SELECTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  76.             Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  77.             Delete with Configuration File . . . . . . . . . . . . . . . . . . . . . . . . .  6
  78.             User Specified Delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  79.             Restore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  80.       AUTOMATIC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  81.             Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  82.             Delete with Configuration File . . . . . . . . . . . . . . . . . . . . . . . . .  8
  83.             User Specified Delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  84.             Restore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  85.  
  86. CHAPTER 3 - COMMAND LINE PARAMETERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  87.       DESCRIPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  88.       AVAILABLE COMBINATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  89.  
  90. CHAPTER 4 - RELATED FILES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  91.       SAVED ENVIRONMENT FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  92.       CONFIGURATION FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  93.  
  94. CHAPTER 5 - LIMITATIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  95.                                   INTRODUCTION
  96.      _____________________________________________________________________
  97.  
  98.  
  99. ENVIRON was written to solve the problem of network administrators adding an
  100. onerous number of environment variables to user's PC's with their own harddisk
  101. and battery of applications.  In our shop, the menu system we use adds about 10
  102. variables that take up approximately 200 bytes.  In addition to managing the
  103. woes created by your friendly network administrator, ENVIRON can also be used
  104. to manage different scenarios where applications need there own subset of
  105. environment variables either to run or to run more efficiently.  The program is
  106. designed for use in batch files once the user becomes comfortable with the
  107. workings by using the "automatic" mode.  Using a little creativity, you should
  108. find it quite easy to accomplish just about anything that has to do with these
  109. little critters.
  110.  
  111. If you find ENVIRON useful, a gift of any amount would be appreciated.  There
  112. is no warranty of any kind.  The copyright owner does not warrant that the
  113. software will meet your requirements or that it is error free, nor may the
  114. copyright owner be help responsible for any loss of profits or data.  Whether
  115. you like the software or not, I would appreciate any comments related to
  116. problems you're having or suggestions for improvement.  Please address all
  117. correspondence to:
  118.  
  119.                            David E. Key
  120.                            6018 Lakehurst Court
  121.                            Arlington, TX  76016-1024
  122.  
  123.  
  124.  
  125.                                     OVERVIEW
  126.      _____________________________________________________________________
  127.  
  128.  
  129. ENVIRON is a utility that can be used to delete selected variables from the DOS
  130. master environment, storing those selected to a file before it does so.  It can
  131. also be used to restore these saved variables, or a selected subset thereof to
  132. the master environment.  There are two modes of operation; "user selected" and
  133. "automatic".
  134.  
  135. "User selected" presents a screen showing the variables, and offering the user
  136. the opportunity to mark them for deletion or restoration.  There are several
  137. options within this mode that can be specified via command line parameters. 
  138. Discussion of these is deferred to the following chapters.
  139.  
  140. "Automatic" simply runs the program "silently" (i.e. no screens are presented
  141. or messages are printed as long as execution completes successfully).  If
  142. execution is completed successfully a value of 0 is returned to DOS upon
  143. termination.  Otherwise a value of 1 is returned.  This mode also provides for
  144. several command line parameters.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.                          CHAPTER 1 - SYSTEM REQUIREMENTS
  154.      _____________________________________________________________________
  155.  
  156.  
  157. HARDWARE
  158. --------------------------------------------------------------------------
  159. The ENVIRON.EXE program requires about 95K of memory.  It was developed and
  160. tested exclusively under MS-DOS 5.00.  How it will behave under another operat-
  161. ing system, I have no idea.  However, because of the method used to "grab" the
  162. master environment, I feel fairly comfortable that it should not be a problem. 
  163. The code is written in C++ and should run on anything greater than or equal to
  164. an 80x86.  There are no floating point routines, so performance with a coproc-
  165. essor is moot.  Disk size is certainly no issue.  The only additional file
  166. space required by the program is exactly equal to the size in bytes of the
  167. variables removed from the environment.
  168.  
  169. A NOTE ON VIDEO
  170. --------------------------------------------------------------------------
  171. ENVIRON writes directly to video memory in "user selected" mode and uses the
  172. following steps to determine what that address should be.  First, the mode is
  173. tested and if it is not equal to 7 the address is set to B800h.  If the mode is
  174. 7, the address used is B000h.  If the mode is equal to 3, color is added,
  175. otherwise text is presented in black and white.  If you experience video
  176. problems it can probably be traced to the above.  "Automatic" mode uses no
  177. video except upon error such as being unable to find the saved environment
  178. file, or being unable to change directories.
  179.  
  180.                              CHAPTER 2 - EXECUTION
  181.      _____________________________________________________________________
  182.  
  183. USER SELECTED
  184. --------------------------------------------------------------------------
  185.       Delete
  186.       ------
  187.       In "user selected" delete mode a screen similar to the following example
  188.       is presented:
  189.  
  190. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ DELETE MODE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  191. ╔═════════════════════════════════════════════════════════════════════════════╗
  192. ║                                 ENVIRON.EXE                                 ║
  193. ║                       Environment Manipulation Utility                      ║
  194. ║                                 Version 3.0                                 ║
  195. ╚═════════════════════════════════════════════════════════════════════════════╝
  196.  
  197. √  PROMPT=$P$G
  198. √  TIGA=-MC:\TIGA -LC:\TIGA
  199. √  CLIPPER=F65,R26,V022,E0,X64
  200. √  RIMID=C6
  201. √  COMSPEC=C:\COMMAND.COM
  202. √  PATH=C:\;C:\DOS5;C:\PCTOOLS;C:\UTIL;C:\XTGOLD;C:\BORLANDC\BIN;C:\NORTON; ...
  203. √  S_1=Home
  204. √  S_2=of
  205. √  S_3=the
  206. √  S_4=free
  207. √  S_5=and
  208.  
  209.            ┌──────────────────────────────────────────────────────┐
  210.            │ Use arrow keys () to highlight item  █  F7 to mark │
  211.            │ / unmark  █  F2 to write selected  variables to file │
  212.            │ and remove from environment █ F10 to abort operation │
  213.            └──────────────────────────────────────────────────────┘
  214. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ PGDN / PGUP for more ... ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  215.  
  216.       The top line of the screen provides information on the mode of operation. 
  217.       In this case, "DELETE MODE".  The available keys are listed in the out-
  218.       lined box near the bottom of the screen.  Not shown here, but obvious in
  219.       the program, the currently selected item is highlighted in BLACK on
  220.       LIGHTGRAY.  The arrow keys can be used to move up and down the list of
  221.       selections.  Those items that are marked with a "√" character are "select-
  222.       ed".  Selection can be toggled on and off by pressing the F7 key.  In this
  223.       mode all items are selected by default when the program is started.  If
  224.       there are more than 11 variables in the environment, a message is dis-
  225.       played on the bottom of the screen stating that PGDN or PGUP can be
  226.       pressed to view the next (or previous) screen of variables.  If any one
  227.       variable is greater than 74 characters in length, it is displayed with 3
  228.       trailing dots (...).  Not to worry, this is merely for cosmetics, the true
  229.       value is still "in there."  However, you would probably think that a good
  230.       program would let you use the right and left arrow keys to view the rest
  231.       of it.  Unfortunately, this isn't one of those kind of "good ones."  Once
  232.       all selections have been made, F2 can be pressed to write out the selected
  233.       variables to the "save" file and to remove them from the environment.  Of
  234.       course, there is an abort key ... pressing F10 at any time discards all
  235.       changes and returns you to DOS.  No changes are made in this instance.
  236.  
  237.  
  238.       Delete with Configuration File
  239.       ------------------------------
  240.       In "user selected" delete with configuration file mode the screen appears
  241.       exactly the same as that for "user selected" delete mode except that the
  242.       items specified in the configuration file are rendered unselectable. 
  243.       Their status is noted on color displays in DARKGRAY on BLUE.  On non-color
  244.       monitors their colors are LIGHTGRAY on BLACK.  It is impossible to over-
  245.       ride their status because the arrow keys cannot be used to highlight them. 
  246.       The top line of screen indicates "RESTRICTED DELETE MODE".
  247.  
  248.       User Specified Delete
  249.       ---------------------
  250.       This mode should not be confused with "user selected" delete mode.  In
  251.       this mode, wildcard parameters are given that specify which variables
  252.       should be marked for deletion by default as opposed to which variables
  253.       should NOT be deleted, or selecting them all.  Once again, the screen
  254.       appears exactly the same as that for "user selected" delete mode except
  255.       that the items matching the wildcard parameters are marked for deletion
  256.       with those not matching not being marked.  All items are available for
  257.       marking/unmarking in this mode.  The top line of screen indicates "DELETE
  258.       MODE".
  259.  
  260.       The wildcard parameters follow the same form as those used by MS-DOS when
  261.       specifying file names to be acted upon by the operating system.  The
  262.       exception to this is that the "?" character is not supported.  If this
  263.       character is used, ENVIRON will search for it explicitly in the list of
  264.       environment variables.  The "*" is supported in one instance only per
  265.       wildcard parameter and may occur anywhere in the string.  Each wildcard
  266.       parameter MUST be separated by one space and should follow a SINGLE "/S:"
  267.       parameter.  A space after the initial "/S:" specifier is optional.  Some
  268.       examples:
  269.  
  270.       The parameter "AS*" would find:
  271.  
  272.                   ASCII
  273.                   ASKME
  274.                   ASTER
  275.  
  276.             it would NOT find:
  277.  
  278.                   FAST
  279.                   RASTER
  280.  
  281.       The parameter "*ED" would find:
  282.  
  283.                   ACTED
  284.                   SUPPORTED
  285.                   SEPARATED
  286.  
  287.             it would NOT find:
  288.  
  289.                   MEDELY
  290.                   BEDS
  291.  
  292.       The parameter "FILE*BIG" would find:
  293.  
  294.                   FILE01BIG
  295.                   FILE02BIG
  296.  
  297.             it would not find:
  298.  
  299.                   FIL001BIG
  300.                   FIL002BIG
  301.  
  302.       Restore
  303.       -------
  304.       In "user selected" delete mode a screen similar to the following example
  305.       is presented:
  306.  
  307. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ RESTORE MODE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  308. ╔═════════════════════════════════════════════════════════════════════════════╗
  309. ║                                 ENVIRON.EXE                                 ║
  310. ║                       Environment Manipulation Utility                      ║
  311. ║                                 Version 3.0                                 ║
  312. ╚═════════════════════════════════════════════════════════════════════════════╝
  313.  
  314. √  NU=C:\NORTON
  315. √  S_FILEDIR=Z:\STATION\C6\
  316. √  S_FILE=49
  317. √  S_LOGIN=DAVID
  318. √  S_DRIVE=F:
  319. √  OS=MSDOS
  320. √  VER=V5.00
  321. √  S_DOS=V5.00
  322. √  S_MENU=RISKMAIN
  323. √  S_PROJECT=RISK_MANAGEMENT
  324. √  PRT_GROUP=RISK_PRT
  325.  
  326.            ┌──────────────────────────────────────────────────────┐
  327.            │  Use arrow keys () to  highlight item   █   F7 to  │
  328.            │  mark / unmark  █  F2 to insert  selected variables  │
  329.            │  into  environment   █   F10  to  abort   operation  │
  330.            └──────────────────────────────────────────────────────┘
  331. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ PGDN / PGUP for more ... ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  332.  
  333.       The screen appears exactly the same as that for "user selected" delete
  334.       mode except that the F2 key restores the saved environment variables to
  335.       the master environment.  All other keys perform the same function as that
  336.       described above.  It should be noted that if all variables from the file
  337.       are not restored, those excluded are lost forever.  An ASCII file of the
  338.       same format could be created to restore these variables later if so
  339.       desired.
  340.  
  341. AUTOMATIC
  342. --------------------------------------------------------------------------
  343.       Delete
  344.       ------
  345.       "Automatic" delete mode performs the same function as "user selected"
  346.       delete mode except that no operator intervention is required or allowed. 
  347.       Unless some sort of unusual error occurs such as being unable to find a
  348.       specified directory or file, operation proceeds "silently" and a value of
  349.       0 is returned to DOS upon completion.  If an error occurs a value of 1 is
  350.       returned to DOS.  As with "user selected" delete, the default is to delete
  351.       all variables from the environment.  This is probably not the desired
  352.       effect so "automatic" delete with configuration file mode is provided to
  353.       retain those variables contained in the configuration file.
  354.  
  355.       Delete with Configuration File
  356.       ------------------------------
  357.       "Automatic" delete with configuration file mode operates the same as its
  358.       "user selected" cousin except that no operator intervention is required or
  359.       allowed.  Unless some sort of unusual error occurs such as being unable to
  360.       find a specified directory or file, operation proceeds "silently" and a
  361.       value of 0 is returned to DOS upon completion.  If an error occurs a value
  362.       of 1 is returned to DOS.  As with the "user selected" mode, the default is
  363.       to delete all variables from the environment except those contained in the
  364.       configuration file.
  365.  
  366.       User Specified Delete
  367.       ---------------------
  368.       "Automatic" user specified delete mode operates the same as its "user
  369.       selected" cousin except that no operator intervention is required or
  370.       allowed.  Unless some sort of unusual error occurs such as being unable to
  371.       find a specified directory or file, operation proceeds "silently" and a
  372.       value of 0 is returned to DOS upon completion.  If an error occurs a value
  373.       of 1 is returned to DOS.  As with the "user selected" mode, the default is
  374.       to delete all variables from the environment that match the wildcard
  375.       parameters specified on the command line.
  376.  
  377.       Restore
  378.       -------
  379.       "Automatic" restore mode performs the same function as "user selected"
  380.       restore mode except that no operator intervention is required or allowed. 
  381.       Unless some sort of unusual error occurs such as being unable to find a
  382.       specified directory or being unable to find the saved environment file,
  383.       operation proceeds "silently" and a value of 0 is returned to DOS upon
  384.       completion.  If an error occurs a value of 1 is returned to DOS.  As with
  385.       "user selected" restore, the default is to restore all variables to the
  386.       environment.  If this is not the desired effect, the saved environment
  387.       file could be edited to include only those needed.
  388.  
  389.                       CHAPTER 3 - COMMAND LINE PARAMETERS
  390.      _____________________________________________________________________
  391.  
  392. DESCRIPTION
  393. --------------------------------------------------------------------------
  394. Usage: 
  395.   C:\>ENVIRON </D|/R[-(save file]|/S:<wildcard(s)>> /C[-(config file] /A /H
  396.  
  397. Available Parameters:
  398.  
  399.       /H                -     Display online help screens.
  400.       /D[-(save file]   -     Delete variables from the environment optionally spec-
  401.                               ifying where to save the variables removed from the
  402.                               environment.  Or, in combination with the "/S" parame-
  403.                               ter, specify where to save the environment variables.
  404.       /C[-(config file] -     Use configuration file to specify those variables that
  405.                               should be excluded from deletion, optionally specify-
  406.                               ing where to find the configuration file.
  407.       /S:<wildcard(s)>  -     Delete all variables that match a specified pattern
  408.                               using the familiar DOS "*" wildcard character.  Multi-
  409.                               ple patterns can be specified by separating them with
  410.                               one space.  Use in combination with "/D" to specify
  411.                               where the variables removed from the environment
  412.                               should be stored
  413.       /R[-(save file]   -     Restore saved variables to the environment, optionally
  414.                               specifying where to find the saved file if other than
  415.                               default.
  416.       /A                -     Automatic mode, no user intervention required or al-
  417.                               lowed.
  418.  
  419. AVAILABLE COMBINATIONS
  420. --------------------------------------------------------------------------
  421. --------------------------------|  /H  |----------------------------------
  422. Display online HELP screens.
  423.  
  424. --------------------------| /D[-(save file]  |----------------------------
  425. User selected DELETE mode, default is delete all.  Optional file name specifies
  426. the drive, path, and name of the file in which to save the variables removed
  427. from the environment.  By default this file is saved in the root directory of
  428. the drive on which ENVIRON.EXE resides, unless overridden.
  429.  
  430. ----------------|  /D[-(save file] /C[-(config file]  |-------------------
  431. User selected DELETE mode, default excludes those variables specified in the
  432. configuration file.  The optional, "/D" "save file" parameter functions the
  433. same as outlined above under "/D[-(save file]".  Optional "config file"
  434. specifies the drive, path, and name of the configuration file.  By default the
  435. configuration file is searched for in the same directory ENVIRON.EXE is stored
  436. in, unless overridden.
  437.  
  438. -----------------------|  /D[-(save file] /A  |---------------------------
  439. Automatic DELETE mode, default is delete all.  The optional, "/D" "save file"
  440. option functions the same as outlined above under "/D[-(save file]".  This is
  441. not a recommended combination as it will nuke everything in your environment.
  442.  
  443. --------------|  /D[-(save file] /C[-(config file] /A  |------------------
  444. Automatic DELETE mode, default excludes those contained in the configuration
  445. file.  The optional, "/D" "save file" and "/C" "config file" parameters
  446. function the same as outlined above under "/D[-(save file] /C[-(config file]".
  447.  
  448. ------------------------|  /S:<wildcards(s)>  |---------------------------
  449. User specified DELETE mode.  Deletes only those variables matching the pat-
  450. tern(s) specified as wildcard(s).  All wildcard patterns must follow the first
  451. and only "/S:".  Subsequent wildcard patterns (after the first) must have 1 and
  452. only 1 space separating them.
  453.  
  454. ----------------------|  /S:<wildcards(s)> /A  |--------------------------
  455. Automatic DELETE mode.  Deletes only those variables matching the pattern(s)
  456. specified as wildcard(s).  All wildcard patterns must follow the first and only
  457. "/S:".  Subsequent wildcard patterns (after the first) must have 1 and only 1
  458. space separating them.
  459.  
  460. ------------------|  /S:<wildcards(s)> /D[-(save file]  |-----------------
  461. User selected DELETE mode.  "/S:" "wildcard(s)" parameter functions the same as
  462. outlined above under "/S:<wildcards(s)>".  The "/D" "save file" parameter
  463. serves only to specify the location for storing the saved environment file.
  464.  
  465. -----------------|  /S:<wildcards(s)> /D[-(save file] /A  |---------------
  466. Automatic DELETE mode.  Functions the same as outlined above under "/S:<wild-
  467. cards(s)> /D[-(save file]".
  468.  
  469. -------------------------|  /R[-(save file]  |----------------------------
  470. User selected RESTORE mode, default is restore all variables contained in the
  471. saved environment file.  Optional file name specifies the drive, path, and name
  472. of the file in which the variables removed from the environment are saved.  By
  473. default this file is saved in the root directory of the drive on which
  474. ENVIRON.EXE resides, unless overridden.  The "save file" option MUST be used if
  475. the environment variables were saved in any location other than the default.
  476.  
  477. -----------------------|  /R[-(save file] /A  |---------------------------
  478. Automatic RESTORE mode.  Restores all variables contained in the saved environ-
  479. ment file.  The optional "save file" specifier function the same, and with the
  480. same requirements as outlined under "/R[-(save file]".
  481.  
  482.       The sequence of these parameters on the command line is insignificant. 
  483.       Specification of individual parameters must be separated by at least one
  484.       space.
  485.  
  486.                            CHAPTER 4 - RELATED FILES
  487.      _____________________________________________________________________
  488.  
  489. SAVED ENVIRONMENT FILE
  490. --------------------------------------------------------------------------
  491.       Upon executing ENVIRON in any of the delete modes a file entitled
  492.       SAVEDENV.TXT is written to the root directory of the disk on which
  493.       ENVIRON.EXE resides unless overridden using the "-(save file" option (see
  494.       description above).  This is a flat, ASCII file that writes each variable
  495.       and its associated value (separated by an "=" sign) to its own line in the
  496.       file.  This file can be edited with a text editor, deleting or adding
  497.       lines as desired.  Just be sure to follow the same format as that found in
  498.       the file created by ENVIRON itself.  Each time this file is written a
  499.       header precedes the variables identifying it as an ENVIRON.EXE byproduct. 
  500.       If the resulting file contains no variables it will still be saved to disk
  501.       with the header line being its only contents.  This allows ENVIRON to
  502.       execute in automatic mode without displaying an error message when a
  503.       restore is attempted and there is really nothing for ENVIRON to do.
  504.  
  505. CONFIGURATION FILE
  506. --------------------------------------------------------------------------
  507.       A copy of an example configuration file should be included with this
  508.       distribution and is entitled ENVIRON.CFG.  It must reside in the same
  509.       directory as ENVIRON.EXE.  Basically, variables to exclude are listed on
  510.       individual lines WITHOUT the associated "=" sign or the variable's pur-
  511.       ported contents.  Comments can be added by placing a semicolon anywhere on
  512.       the line.
  513.  
  514.  
  515.  
  516.                             CHAPTER 5 - LIMITATIONS
  517.      _____________________________________________________________________
  518.  
  519. There are several limitations in the program worth mentioning.  First, the
  520. number of environment variables that the program can handle is limited to 64. 
  521. In User Selected Delete Mode, the maximum number of wildcard combinations
  522. following the "/S:" parameter is 15.  And finally, environment variables
  523. greater than 128 characters in length are not supported.
  524.  
  525. One "quirk" I have found, and still don't know the reason for, relates to
  526. deleting the "COMSPEC" variable from the environment.  The variable is not
  527. visible after using the DOS "SET" command, and restores without problem.  But,
  528. shortly after that some or all of the environment variables disappear when
  529. other applications are used.  For this reason I would strongly suggest that you
  530. NOT delete the "COMSPEC" variable.